.. _cmcPmOverrideSpeedSet:

cmcPmOverrideSpeedSet 
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmcPmSetOverrideSpeedSet ([in] VT_I4 BoardID,  [in] VT_I4 NodeId, [in] VT_I4 Channel )               

DESCRIPTION
`````````````  

- cmcPmOverrideSpeedSet() 함수는 단축 모션이 진행되고 있는 중에 속도를 오버라이딩 하고자 할 때 
  사용하는 함수입니다. 속도를 오버라이딩 하기 위해서는 먼저 cmcPmCfgSpeedPatternSet() 속도 패턴 설정 
  함수를 통하여 변경하고자 하는 속도 또는 가속도 값을 설정하고 나서 이 함수를 수행해야 합니다. 

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cmc 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ NodeId : 노드 번호. 노드 번호는 3부터 시작합니다. 
 
▶ Channel : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 최대 
통합 축 개수 - 1 이하의 값을 축 번호로 설정할 수 있습니다. 


RETURN VALUE
`````````````

.. csv-table::
  :widths: 10 90
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  음수, 수행 실패
  ERR_NONE, 수행 성공

REFERENCE
`````````````

- 보간 작업을 수행하는 경우에는 속도 오버라이딩을 사용할 수 없습니다.

EXAMPLE
```````````````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    C/C++ 
    #include “ComiMLink3_SDK.h” 
    #include “ComiMLink3_SDK_Def.h” 
    long BoardID = 0; 
    //0번 축의 속도를 설정합니다. 
    cmcPmCfgSetSpeedPattern(BoardID, 3, ccmcX1, cmcMODE_S, 5000, 30000, 30000 ); 
    cmcPmSxSetSpeedRatio(BoardID, 3, ccmcX1, ccmcSMODE_KEEP, 100, 100, 100 ); 
    //0번 축을 구동 시킵니다. 
    cmcPmSxMoveStart(BoardID, 3, ccmcX1, 15000 ); 
    //오버라이드 할 축 및 속도를 지정합니다. 
    cmcPmCfgSetSpeedPattern(BoardID, 3, ccmcX1, cmcMODE_S, 1000, 10000, 10000 ); 
    /*cmcPmSxSetSpeedRatio()함수를 이용하여  
    오버라이드 할 속도를 설정 할 수 있습니다.*/ 
    //cmcPmSxSetSpeedRatio(BoardID, 3, ccmcX1, ccmcSMODE_KEEP, 70, 70, 70 ); 
    //속도를 오버라이드 합니다. 
    cmcPmOverrideSpeedSet(BoardID, 3, ccmcX1 );